home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / print / pascii17.zip / pascii17.doc < prev   
Text File  |  1994-03-31  |  6KB  |  144 lines
  1.  
  2.  
  3.            PASCII 1.7   Copyright 1993-1994 by Joohee Jeong
  4.  
  5.                      (Released on Mar.31, 1994)
  6.  
  7.  
  8.  
  9.   Overview:  PASCII prepares an ASCII file for printing.   Supports
  10.     header/footer, pagination,  file-name,  time/date  of  printing,
  11.     time/date of file, one/two-sided printing, line numbering, left
  12.     margin (even/odd side), top margin, bottom margin, line-breaking,
  13.     FormFeed character,  TAB character expansion.   Removes trailing
  14.     blanks. Handles UNIX text files.         ** Freeware **
  15.  
  16.  
  17.   What's new:
  18.  
  19.    v1.5: Some bugs related to FormFeed character and header/footer
  20.          fixed.
  21.  
  22.    v1.6: Removes ASCII-26 at the end of file.  Minor bug fix.
  23.          Smaller executable size.
  24.  
  25.    v1.7: Added an option to reverse the order of the pages in PASCII.EVN.
  26.          TAB expansion didn't work at all.  Fixed.
  27.  
  28.   Installation:  Put the two files PASCII.EXE and PASCII.CFG in some
  29.     directory in your PATH.
  30.  
  31.  
  32.   Usage:  pascii [options] filename
  33.  
  34.           options = -1 or -2         (1 or 2 sided printing)
  35.                     -num[+-]         (line numbering on/off)
  36.                     -c filename      (configuration file)
  37.                     -tab n           (TAB size 1 <= n <= 16)
  38.                     -header[+-]      (header on/off)
  39.                     -footer[+-]      (footer on/off)
  40.                     -headfooter[+-]  (header/footer on/off)
  41.  
  42.     If one-sided printing option is selected, then PASCII produces the
  43.     output file PASCII.OUT (in the current directory), which can be sent
  44.     to the printer by the DOS command:
  45.       copy pascii.out prn
  46.     If two-sided printing option is selected, then PASCII produces two
  47.     output files PASCII.EVN (for page 2,4,6,...) and PASCII.ODD (for
  48.     page 1,3,5,...), which can be sent to the printer by the DOS
  49.     commands:
  50.       copy pascii.evn prn
  51.       copy pascii.odd prn
  52.     You can have PASCII.EVN reversely ordered by setting the last entry
  53.     in PASCII.CFG 1 (i.e., "true").
  54.     It is convenient to have batch files pout.bat (peven.bat, podd.bat,
  55.     resp.) that consists of the single line "copy pascii.out prn" ("copy
  56.     pascii.evn prn", "copy pascii.odd prn", resp.) in some directory in
  57.     your PATH.
  58.  
  59.     If an input file is non-ASCII, then no output is generated.
  60.  
  61.  
  62.   Configuration:  All options are specified in a configuration file, say
  63.     PASCII.CFG, which is first searched in the current directory and
  64.     then in the directory in which PASCII.EXE resides.  This
  65.     configuration file PASCII.CFG can be freely edited by any text
  66.     editor.  The order of the configuration variables (i.e., options)
  67.     matters.  You should not mess up the order.  Blank lines are ignored.
  68.     Any text after the comment character `%' is ignored.
  69.       Following is an example of PASCII.CFG:
  70.  
  71.       66                              % 30 <= pageheight <= 80
  72.       80                              % 30 <= pagewidth <= 90
  73.       2                               % 1 or 2 sided
  74.       2                               % 0 <= top margin <= 30
  75.       2                               % 0 <= bottom margin <= 30
  76.       6                               % 0 <= even margin <= 40
  77.       10                              % 0 <= odd margin <= 40
  78.       8                               % 1 <= TabSize <= 16
  79.       \page/\npages \hfill{─} \filename      % even header
  80.       \filename \hfill{─} \page/\npages      % odd header
  81.       \page/\npages \hfill{─} (Printed on \ptime) \filename % even footer
  82.       Last modified on \ftime \hfill{─} \page/\npages       % odd footer
  83.       0                               % line numbering: 1=true, 0=false
  84.       1                               % use header: 1=true, 0=false
  85.       1                               % use footer: 1=true, 0=false
  86.       1                               % reverse PASCII.EVN: 1=true, 0=false
  87.  
  88.     If one-sided printing option is selected, then the parameters for
  89.     odd pages are used for all pages, odd or even. (That is, parameters
  90.     for even pages are ignored.)
  91.  
  92.     Everything except possibly the "commands" in header/footer will be
  93.     self-evident:
  94.       \page is the current page
  95.       \npages is the total number of pages
  96.       \filename is the input filename
  97.       \ptime is the date and time of printing
  98.       \ftime is the date and time of the input file
  99.       \hfill{x} inserts the characters x to fill the line.  \hfill
  100.          is identical to \hfill{ }
  101.  
  102.  
  103.   Command line options:  Some configuration options in PASCII.CFG that
  104.     need frequent change can be overridden by command line switches.
  105.       The switch -1 (-2, resp.) forces one-sided printing (two-sided
  106.     printing, resp.).
  107.       The switch -num (-num-, resp.) forces line numbering (line
  108.     no-numbering, resp.).  -num+ has the same effect as -num.
  109.       The switch -tab n can be used to set the tab size to n, where
  110.     1 <= n <= 16.
  111.       The switch -header (-header-, resp.) forces to use header (not to
  112.     use header, resp.).  -header+ has the same effect as -header.
  113.       The switches -footer[+-] and -headfooter[+-] should be obvious.
  114.  
  115.     Moreover, the configuration file itself can be specified by the
  116.     command line switch -c: for instance,
  117.  
  118.       pascii -c source.cfg somefile
  119.  
  120.     processes the input file SOMEFILE using the configuration variables
  121.     in SOURCE.CFG (first searched in the current directory and then in
  122.     the directory in which PASCII.EXE resides).
  123.  
  124.  
  125.   Limitations:
  126.     (i)  Doesn't accept multiple input files.
  127.     (ii) Doesn't process an input file if the file name is one among
  128.          PASCII.OUT, PASCII.EVN and PASCII.ODD.
  129.     (iii) FormFeed character must be either the first or the last
  130.          character of a line.
  131.     (iv) Each CarriageReturn character must be followed by a LineFeed
  132.          character.
  133.     (v) Cannot prevent line-breaking in trailing blanks.
  134.  
  135.   DISCLAIMER:  This software comes with absolutely no warranty.  In
  136.     no event the author shall be liable for direct, indirect or con-
  137.     sequential damages, loses, costs, fees or expenses of any nature
  138.     or kind.
  139.  
  140.   ----------------------------------------------------------------
  141.   Joohee Jeong                    Author of JSpell (ASP Shareware)
  142.   Email: 73072.3651@compuserve.com        Phone/Fax (510) 528-8753
  143.   Nemosoft Technologies, P.O.Box 1619, El Cerrito, CA 94530, U.S.A.
  144.